home *** CD-ROM | disk | FTP | other *** search
/ Gold Medal Software 3 / Gold Medal Software - Volume 3 (Gold Medal) (1994).iso / comms / vfast13.arj / VFAST.DOC < prev    next >
Text File  |  1994-03-22  |  9KB  |  224 lines
  1.          Vfast             Technical Reference Manual           Page 1
  2.  
  3.                                   vFAST v1.3
  4.             Copyright 1993-94 (c) International TeleCommunications
  5.                               All Rights Reserved
  6.  
  7.                                  Introduction
  8.  
  9.          vFAST  was designed specifically for v32, v32bis,  and  vFAST
  10.          modems. You should not attempt to use vFAST with a 2400  baud
  11.          modem  unless your modem is error correcting.   The reason, a
  12.          single  error could produce a resend request for as  much  as
  13.          8192  bytes. It COULD be as little as 256 bytes but the  risk
  14.          of 8192... well that is up to you.
  15.  
  16.          vFAST needs ONE of the following:
  17.  
  18.          16550 Uart
  19.          Intelligent Digiboard (2, 4, 8, or 16 port).
  20.          Intelligent Stargate.
  21.          Intelligent Arnet.
  22.  
  23.          If you don't have one of the above, well try  and see.   You
  24.          MIGHT be able to keep up but I doubt it.
  25.  
  26.          vFAST  is just what the name implies, a vERY  FAST  protocol,
  27.          it'll run circles around Zmodem.
  28.  
  29.          vFAST  uses  DUAL 16 bit CRC's to protect  data.  Each  SHORT
  30.          block  of  data  has a 16 bit CRC and every  8192  bytes  has
  31.          another 16 bit crc. In short, CRC's inside of CRC's. Just  as
  32.          effective  as  one single 32 bit crc but has  much  less  CPU
  33.          overhead.
  34.  
  35.          vFAST  has RESTART recovery for aborted transfers as well  as
  36.          SKIP for files you ALREADY have.
  37.  
  38.          One  way  to BOOST speed and cut down on CPU overhead  is  to
  39.          reduce  SCREEN writes to a bare MINIMUM. We'll only show  you
  40.          enough  data on the screen to let you know what is going  on.
  41.          We'll only update the screen, unless an error occurs,  every
  42.          8192 bytes.
  43.  
  44.          You can ABORT a transfer by pressing ESC. Again, to keep  CPU
  45.          overhead  low, we only check the  keyboard every  8192  bytes
  46.          so  there may be a short delay  between  the time  you  press
  47.          ESC and the program acknowledges the ESC.
  48.  
  49.          Once you see the acknowledgment, nothing may appear to happen
  50.          for upwards of 10 to 12 seconds. vFAST is attempting to clear
  51.          out the RX buffer and phone lines before exiting, to  prevent
  52.          garbage  from spraying all over your screen.
  53.  
  54.  
  55.  
  56.          Vfast             Technical Reference Manual           Page 2
  57.  
  58.                              Hardware Requirements
  59.  
  60.          You need a 386, 486, or Pentium processor. vFast will NOT run
  61.          on a 8088 or 80286 micro processor.
  62.  
  63.                              Command Line Switches
  64.  
  65.          vFAST supports the following command line switches:
  66.  
  67.          -Tx            Use Timeslicing when you cannot send or
  68.                         receive anything. x is the TYPE of time
  69.                         slicing. Valid TYPES are:
  70.  
  71.                         D         Desqview
  72.                         O         OS-2
  73.                         W         Windows
  74.  
  75.                         If  you use OS-2 or Windows Time Slicing,  you
  76.                         must have have  DPMI turned on.
  77.  
  78.          -Bxxxxx        xxxx is the connect baud rate.
  79.  
  80.          -Pxxx          xxxx is the serial port, 1-4 if using the
  81.                         standard internal driver.
  82.  
  83.          -Lxxxx         xxxx is Serial LOCK rate, 9600 - 115200.
  84.  
  85.          -S  <Fnames>   Start Sending files. Fnames is the  names  of
  86.                         the  files  to  send.  Each  name  should   be
  87.                         separated  by a single blank space. If  Fnames
  88.                         is  prefixed  with an AT sign, @,  vFAST  will
  89.                         ASSUME  Fnames is the name of a  SEND  control
  90.                         file.
  91.  
  92.                         E.g.  -S @C:\TERM\SEND.CTL
  93.  
  94.                         SEND.CTL would be a text file listing the
  95.                         files to send, one per line. Drive, path,
  96.                         and DOS wildcards supported.
  97.  
  98.                         This must be the LAST command line switch used.
  99.  
  100.          -D<TYPE>       The TYPE of serial driver to use. Valid <TYPE>
  101.                         are:
  102.  
  103.                         D       Digiboard
  104.                         S       Stargate
  105.                         A       Arnet
  106.  
  107.                        The default is the internal (Standard DOS  type
  108.                        serial ports) highspeed serial driver.
  109.  
  110.  
  111.          Vfast             Technical Reference Manual           Page 3
  112.  
  113.          -N*N          If you're running vFAST as a protocol driver
  114.                        with Osiris XLT, include this switch.
  115.  
  116.  
  117.          -R            Begin Receiving, must be the LAST command line
  118.                        switch used.
  119.  
  120.          -K            Disable Keep Aborted Transfers. The default it
  121.                        to keep all partial transfers. If you use this
  122.                        driver as an external protocol driver for a BBS
  123.                        you'll  want  to include this  on  the  command
  124.                        line.
  125.  
  126.          -U<PATH>      This tells vFAST to place all files you receive
  127.                        in   THIS  directory.  This  feature  is   ONLY
  128.                        available if you register vFAST.
  129.  
  130.          -!<FILENAME>  This tells vFAST to pull the callers name from
  131.                        DOOR.SYS, DOOR1.SYS, DOOR2.SYS, etc. This file
  132.                        must be in DOOR.SYS format and you must supply
  133.                        the full drive, path, AND filename.
  134.  
  135.                        E.g.  -!C:\PCBOARD\DOOR.SYS
  136.  
  137.                        NOTE:   This  feature  is  only  available   in
  138.                        REGISTERED mode.
  139.  
  140.          -W<LOGFILE>   This allows you to redirect the log file to any
  141.                        drive, directory, and file. You must supply the
  142.                        full drive, path, AND filename.
  143.  
  144.                        E.g.  -WC:\PCBOARD\JOHN.LOG
  145.  
  146.                        NOTE:   This  feature  is  only  available   in
  147.                        REGISTERED mode.
  148.  
  149.  
  150.                     Command Lines For Sending And Receiving
  151.  
  152.          The  minimum  command  line for RECEIVING  a  file  would  be
  153.          something like this:
  154.  
  155.          vFAST -B<BaudRate> -L<LockRate> -P<Port Number> -R
  156.  
  157.          How  you  pass  the parameters will vary  depending  on  your
  158.          terminal  software or bbs software. Check  the  documentation
  159.          that came with your terminal or bbs software for specifics.
  160.  
  161.          Assuming  your BBS/Terminal requires batch files  and  passes
  162.          baudrate  in  %1,  port  number in  %2  then  you  might  use
  163.          something like this:
  164.  
  165.          vfast -B%1 -L57600 -P%2 -R
  166.          Vfast             Technical Reference Manual           Page 4
  167.  
  168.          The  minimum  command  line  for  SENDING  a  file  would  be
  169.          something like this:
  170.  
  171.          vFAST -B<BaudRate> -L<LockRate> -P<Port Number> -S <Ctl Filename>
  172.  
  173.          Notice, and this is VERY important, the space between -S  and
  174.          <Ctl  Filename>. If you forget to put a space there,  nothing
  175.          will happen.
  176.  
  177.          How  you  pass  the parameters will vary  depending  on  your
  178.          terminal  software or bbs software. Check  the  documentation
  179.          that came with your terminal or bbs software for specifics.
  180.  
  181.          Assuming your BBS/Terminal passes baudrate in %1, port number
  182.          in  %2,  and the name of the file in %3, then you  might  use
  183.          something like this:
  184.  
  185.          vfast -B%1 -L57600 -P%2 -S %3
  186.  
  187.              Examples of how to install vfast.exe with Osiris XLT
  188.  
  189.          Example of an Osiris XLT Rcv cmdline:
  190.  
  191.          VFAST -B*B -L*L -N*N -P*P -K -R
  192.  
  193.          Example of an Osiris XLT Send cmdline:
  194.  
  195.          VFAST -B*B -L*L -N*N -P*P -S @*U
  196.  
  197.                                    Shareware
  198.  
  199.          vFAST is shareware. Meaning you can use it for up to 30  days
  200.          without  registering  it. When you finish your  download,  or
  201.          uploads,  the  shareware version will pause for  30  seconds.
  202.          Registering  vFAST  removes  this delay and  enables  the  -U
  203.          switch.
  204.  
  205.                                vFAST Order Form
  206.  
  207.          Send $15.00 (US Currency) to:
  208.  
  209.                        International TeleCommunications
  210.                                 302 W. Mckinley
  211.                           Poplar Bluff Mo. 63901-6372
  212.                            United States Of America
  213.  
  214.  
  215.          Register To (___________________________________)
  216.  
  217.  
  218.          A  registration key will be placed on our BBS at  (314)  686-
  219.          0120 for you. The key will be password protected so only  YOU
  220.          can download it. What Password do you want to use?
  221.  
  222.          Password (________)
  223.  
  224.